Skip to content

Document automatic certificate selection in Chrome on ChromeOS#513

Merged
tashian merged 2 commits into
mainfrom
carl/con-263-document-automatic-certificate-selection-in-chrome-on
May 21, 2026
Merged

Document automatic certificate selection in Chrome on ChromeOS#513
tashian merged 2 commits into
mainfrom
carl/con-263-document-automatic-certificate-selection-in-chrome-on

Conversation

@tashian
Copy link
Copy Markdown
Contributor

@tashian tashian commented May 20, 2026

Summary

  • Adds a ChromeOS section to tutorials/browser-certificate-setup-guide.mdx covering automatic client certificate selection for both HTTPS (via the AutoSelectCertificateForUrls Chrome policy in the Google Workspace Admin Console) and 802.1X Wi-Fi (via Issuer pattern set to the full Smallstep intermediate CA common name).
  • Updates the guide intro to include ChromeOS in the supported platforms list.

Closes CON-263.

🤖 Generated with Claude Code

Closes CON-263

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@tashian tashian requested a review from a team as a code owner May 20, 2026 22:20
@tashian tashian enabled auto-merge May 20, 2026 22:33
4. Add an entry for each protected URL, in the following format:

```json
{"pattern":"[Server URL pattern]","filter":{"ISSUER":{"CN":"Smallstep [Team Slug] Accounts Intermediate CA"}}}
Copy link
Copy Markdown
Member

@hslatman hslatman May 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

On ChromeOS, we currently only get certs from the Devices authority.

Suggested change
{"pattern":"[Server URL pattern]","filter":{"ISSUER":{"CN":"Smallstep [Team Slug] Accounts Intermediate CA"}}}
{"pattern":"[Server URL pattern]","filter":{"ISSUER":{"CN":"Smallstep [Team Slug] Devices Intermediate CA"}}}

Adding support for (known) additional authorities with ACME DA provisioners shouldn't take long. Making the ChromeOS agent work fully similar to the agent will require more time, though.

4. Set the **Issuer pattern** to the full common name of your Smallstep intermediate issuing CA:

```
Smallstep [Team Slug] Accounts Intermediate CA
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Smallstep [Team Slug] Accounts Intermediate CA
Smallstep [Team Slug] Devices Intermediate CA

- Example: `[.*]xample.com` matches `xample.com` and `hello.xample.com` for any scheme, port, and path. It will not match `example.com`.
- For more examples, see [the Chrome Enterprise docs](https://chromeenterprise.google/policies/url-patterns/).

Replace `[Team Slug]` with your Smallstep team slug.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did we remove the parentheses from the automatically generated names? In my testing I had to use, (Team Slug).

@tashian tashian merged commit 47a10bb into main May 21, 2026
4 checks passed
@tashian tashian deleted the carl/con-263-document-automatic-certificate-selection-in-chrome-on branch May 21, 2026 10:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants